home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / SOUND / MATTRK1 / !S3M2MTRX / Link / Docs / !FXSpec next >
Text File  |  1996-04-02  |  11KB  |  313 lines
  1. ————————————————————————————————————————————————————————————————————ALT+152——
  2. matrixTRK pattern format description
  3. —————————————————————————————————————————————————————————————————————————————
  4.  
  5. A pattern entry has the following format:
  6.  
  7.     | &12 | &01 | &40 | &1802 |
  8.  
  9. &12 - note &00 .. &5F, &08 octaves * &0C notes = &60, &00 is C-0, &5F is B-7,
  10.       an emty note has a value of &FF, &FE means sample off
  11.  
  12. &01 - sample number the note will be played with, &FE samples are possible,
  13.       an emty sample number has a value of &00
  14.  
  15. &40 - volume entry for specified note, &00 .. &40 is possible, values above
  16.       &40 are ignored. an emty volume entry has a value of &FF
  17.  
  18. &18 - effect number (described below), an emty effect number has a value of
  19.       &00
  20.  
  21. &02 - effect parameter depending on effect number (described below), an emty
  22.       effect parameter has a value of &00
  23.  
  24. a pattern row consists of pattern entries for 1 to a maximum of 32 voices. a
  25. pattern consists of 1 to a maximum of 64 pattern rows.
  26.  
  27. for further details on how the whole thing works see the ScreamTracker3
  28. documentation and technical documentation.
  29.  
  30. —————————————————————————————————————————————————————————————————————————————
  31. matrixTRK sound effect description
  32. —————————————————————————————————————————————————————————————————————————————
  33.  
  34. —————————————————————————————————————————————————————————————————————————————
  35. pitch manipulation effects
  36. —————————————————————————————————————————————————————————————————————————————
  37.  
  38. &001x    set fine tune
  39.  
  40. that command was implemented to retain PROTracker compatibility. it changes
  41. the instrument record frequency to a desired value. so you can correct the
  42. instrument pitch. effect parameters are:
  43.  
  44.     8    - 7895 Hz
  45.     9    - 7941 Hz
  46.     A    - 7985 Hz
  47.     B    - 8046 Hz
  48.     C    - 8107 Hz
  49.     D    - 8169 Hz
  50.     E    - 8232 Hz
  51.     F    - 8280 Hz
  52.     0    - 8363 Hz (No finetune)
  53.     1    - 8413 Hz
  54.     2    - 8463 Hz
  55.     3    - 8529 Hz
  56.     4    - 8581 Hz
  57.     5    - 8651 Hz
  58.     6    - 8723 Hz
  59.     7    - 8757 Hz
  60.  
  61. &002x    pitch fine slide up
  62. &003x    pitch extra fine slide up
  63.  
  64. increases the pitch by x on the first frame of the note only. in case of x=0
  65. the previous 'pitch fine slide' parameter will be used. if the note exceeds
  66. the limit specified by the Amiga compatibility the slide operation will be
  67. stopped.
  68.  
  69. &02xx    pitch slide up
  70.  
  71. slides up the pitch of the note as specified by xx (speed-1 times). in case
  72. of xx=0 the previous 'pitch slide' parameter will be used. if the note
  73. exceeds the limit specified by the Amiga compatibility the slide operation
  74. will be stopped.
  75.  
  76. &004x    pitch fine slide down
  77. &005x    pitch extra fine slide down
  78.  
  79. decreases the pitch by x on the first frame of the note only. in case of x=0
  80. the previous 'pitch fine slide' parameter will be used. if the note exceeds
  81. the limit specified by the Amiga compatibility the slide operation will be
  82. stopped.
  83.  
  84. &03xx    pitch slide down
  85.  
  86. slides down the pitch of the note as specified by xx (speed-1 times). in case
  87. of xx=0 the previous 'pitch slide' parameter will be used. if the note
  88. exceeds the limit specified by the Amiga compatibility the slide operation
  89. will be stopped.
  90.  
  91. &04xy    tone arpeggio
  92.  
  93. changes the playing note between the note, the note + x halfnotes and the
  94. note + y halfnotes. in case of xy=0 the previous 'arpeggio' parameter is
  95. used. if the note + halfnotes exeeds the limit specified by the Amiga
  96. compatibility the note will be muted.
  97.  
  98. &006x    tone glissando control
  99.  
  100. setting x=0 (default) makes 'tone portamento' act normally (continous
  101. sliding). setting x=1 makes 'tone portamento' slide from halfnote to halfnote
  102. on the given channel.
  103.  
  104. &05xx    tone portamento
  105.  
  106. starts changing the current pitch to match the note given with this command.
  107. following 'tone portamento' will continue sliding the pitch until the note is
  108. reached. the portamento will then be stopped. in case of xx=0 the previous
  109. 'tone portamento' parameter will be used.
  110.  
  111. &06xy    tone portamento volume
  112.  
  113. requires the previous use of a 'tone portamento'. it will continue the 'tone
  114. portamento' and slides the volume like a normal volume slide with the value
  115. xy. in case of xy=0 the previous 'volume slide' parameter will be used. You
  116. cannot use fine volume sliding.
  117.  
  118. &007x    vibrato set waveform
  119.  
  120. sets the waveform of the vibrato. the options x are:
  121.  - 0    sine waveform (default),
  122.  - 1    ramp down,
  123.  - 2,3  square waveform.
  124. if bit 2 of x is clear the vibrato counter restarts every note.
  125.  
  126. &07xy    vibrato
  127.  
  128. vibrates the note by changing the pitch with speed x and depth y. in case of
  129. x=0 the previous 'vibrato speed' parameter will be used else if y=0 the
  130. previous 'vibrato depth' parameter will be used.
  131.  
  132. &08xy    vibrato fine
  133.  
  134. vibrates the note by changing the pitch with speed x and depth y just like
  135. normal vibrato, but is four times more accurate. if a note is played with a
  136. very high frequency, a normal vibrato might sound too strong, so a fine
  137. vibrato can be used. in case of x=0 the previous 'vibrato speed' parameter
  138. will be used else if y=0 the previous 'vibrato depth' parameter will be used.
  139.  
  140. &09xy    vibrato volume
  141.  
  142. requires the previous use of a 'vibrato'. it will continue the 'vibrato' and
  143. slides the volume like a normal volume slide with the value xy. in case of
  144. xy=0 the previous 'volume slide' parameter will be used. you cannot use fine
  145. volume sliding.
  146.  
  147. —————————————————————————————————————————————————————————————————————————————
  148. volume manipulation effects
  149. —————————————————————————————————————————————————————————————————————————————
  150.  
  151. &10xx    volume set global
  152.  
  153. changes the global volume the whole song is played with. accepted values
  154. for xx are &00..&40.
  155.  
  156. &11xx    volume slide global
  157.  
  158. slides the global volume the whole song is played with. accepted values
  159. for xx are &80(-128)..&FF(-1)..&00(0)..&7F(127).
  160.  
  161. &00Ax    volume fine slide up
  162.  
  163. increases the volume by x on the first frame of the note only. in case of x=0
  164. the previous 'volume fine slide' parameter will be used.
  165.  
  166. &00Bx    volume fine slide down
  167.  
  168. decreases the volume by x on the first frame of the note only. in case of x=0
  169. the previous 'volume fine slide' parameter will be used.
  170.  
  171. &12xy    volume slide
  172.  
  173. slides up the volume with the value of x (y must be 0) or down with the value
  174. of y (x must be 0). the amount of the slide will be (speed-1)*x or
  175. (speed-1)*y. the volume can't be higher than &40. in case of xy=0 the
  176. previous 'volume slide' parameter will be used.
  177.  
  178. &00Ax    tremolo set waveform
  179.  
  180. sets the waveform of the tremolo. the options x are:
  181.  - 0    sine waveform (default),
  182.  - 1    ramp down,
  183.  - 2,3  square waveform.
  184. if bit 2 of x is clear the tremolo counter restarts every note.
  185.  
  186. &13xy    tremolo
  187.  
  188. vibrates the note volume with speed x and depth y. all volumes higher &40
  189. will be clipped at &40. in case of x=0 the previous 'tremolo speed' parameter
  190. will be used. in case of y=0 the previous 'tremolo depth' parameter will be
  191. used.
  192.  
  193. —————————————————————————————————————————————————————————————————————————————
  194. note manipulation effects
  195. —————————————————————————————————————————————————————————————————————————————
  196.  
  197. &18xx    note set speed
  198.  
  199. determines the NUMBER OF FRAMES one note is played until the next note can
  200. start (i.e. song speed). the range of xx is
  201. &00(ignored)..&01(fast)..&06(default)..&FF(slow).
  202.  
  203. &19xx    note set speed
  204.  
  205. determines the TIME OF ONE FRAME. one frame is 1/50 second by default. the
  206. range of xx is &00(ignored)..&01(slow)..&7D(default)..&FF(fast).
  207.  
  208. &1Axx    note delay
  209.  
  210. delays the playing of the new note x frames. during the delay time the
  211. previous note will be played.
  212.  
  213. &1Bxx    note cut
  214.  
  215. cuts the note after x frames (i.e. sets volume to 0).
  216.  
  217. &1Cxy    note retrig and volume slide
  218.  
  219. triggers the sample many times in one row. the y value specifies the number
  220. of frames between the retrigs. there are <speed> frames in one row. the x
  221. value specifies if there should be a 'volume slide' between the retrigs. in
  222. case of xy=0 the previous 'retrig' parameter will be used. the amount the
  223. volume will be changed every retrig is shown in the following table:
  224.  
  225.     0:  &00    (No volume slide)
  226.     1: -&01
  227.     2: -&02
  228.     3: -&04
  229.     4: -&08
  230.     5: -&10
  231.     6:  2/3 times the previous volume
  232.     7:  1/2 times the previous volume
  233.     8:  &00 (No volume slide)
  234.     9: +&01
  235.     A: +&02
  236.     B: +&04
  237.     C: +&08
  238.     D: +&10
  239.     E:  3/2 times the previous volume
  240.     F:  2    times the previous volume
  241.  
  242. &1Dxy    note tremor
  243.  
  244. turns the note on for x frames and off for y frames. in case of xy=0 the
  245. previous 'tremor' parameter will be used. if one part of the parameter is 0
  246. the note will be played continously.
  247.  
  248. —————————————————————————————————————————————————————————————————————————————
  249. pattern manipulation effects
  250. —————————————————————————————————————————————————————————————————————————————
  251.  
  252. &20xx    pattern loop
  253.  
  254. is used for looping inside the pattern. first, you must use a 'pattern loop'
  255. command with parameter xx=0 to set the loop start. then use 'pattern loop'
  256. command with parameter xx<>0 to return to the loop start xx times. it is not
  257. possible to loop back to a loop start in another pattern! if you try that or
  258. if you don't enter an x=00 parameter, the loop start is equal to pattern
  259. start. (not coded yet)
  260.  
  261. &21xx    pattern delay
  262.  
  263. repeats the current row xx times without triggering the notes again but
  264. applying the effects.
  265.  
  266. &13xx    pattern break
  267.  
  268. leaves the pattern after playing the current row. it will jump to row xx in
  269. the next pattern according to the song sequence (decimal because of Amiga
  270. compatibility, example: &12 means 12 decimal).
  271.  
  272. —————————————————————————————————————————————————————————————————————————————
  273. sequence manipulation effects
  274. —————————————————————————————————————————————————————————————————————————————
  275.  
  276. &24xx    sequence position jump relative
  277.  
  278. jumps relative to the sequence entry specified by the xx parameter. The
  279. current row is still played, but the next row will be the first one of the
  280. pattern at sequence entry: current sequence position + xx. the range of xx is
  281. &80(-128)..&FF(-1)..&00(0)..&7F(127).
  282.  
  283. &4xxx    sequence position jump absolute
  284.  
  285. jumps absolute to the sequence entry specified by the xxx parameter. The
  286. current row is still played, but the next row will be the first one of the
  287. pattern at sequence entry xxx.
  288.  
  289. —————————————————————————————————————————————————————————————————————————————
  290. sample manipulation effects
  291. —————————————————————————————————————————————————————————————————————————————
  292.  
  293. &3xxx    sample set offset
  294.  
  295. starts playing the sample at offset 256 times xxx. if the sample offset is
  296. used in a looped sample and the offset given exceeds the loop end value, the
  297. loop is taken into consideration and the offset will be calculated as if the
  298. sample had looped. in case of xxx=0 the previous 'sample offset' parameter
  299. will be used.
  300.  
  301. —————————————————————————————————————————————————————————————————————————————
  302. channel manipulation effects
  303. —————————————————————————————————————————————————————————————————————————————
  304.  
  305. &00Dx    channel set stereo
  306.  
  307. sets the balance of the current channel to x, where &00 is left and &07
  308. right.
  309.  
  310. —————————————————————————————————————————————————————————————————————————————
  311.  
  312. edited by ‘Lord of the earwigs’ Wed 27th March 1996
  313.